home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 52 / Mac Magazin and MacEasy Magazine CD - Issue 52.iso / Updates / Stata 5.0 Ado-files / ado.sea / newado / svymean.hlp < prev    next >
Text File  |  1998-11-22  |  6KB  |  152 lines
  1. .-
  2. help for ^svymean^, ^svytotal^, ^svyratio^, ^svyprop^            (manual:  ^[R] svymean^)
  3. .-
  4.  
  5. Estimate means, totals, ratios, and proportions for survey data
  6. ---------------------------------------------------------------
  7.  
  8.     ^svymean^  varlist [weight] [^if^ exp] [^in^ range] [^,^ common_options]
  9.  
  10.     ^svytotal^ varlist [weight] [^if^ exp] [^in^ range] [^,^ common_options]
  11.  
  12.     ^svyratio^ varname [^/^] varname [varname [^/^] varname ...] 
  13.              [weight] [^if^ exp] [^in^ range] [^,^ common_options]
  14.  
  15.     ^svyprop^  varlist [weight] [^if^ exp] [^in^ range] [^,^ svyprop_options]
  16.  
  17. where common_options are 
  18.         ^str^ata^(^varname^) psu(^varname^) fpc(^varname^) by(^varlist^)^
  19.         {^com^plete|^av^ailable} ^sub^pop(varname) ^srs^subpop ^nolab^el
  20.         ^l^evel^(^#^) ci deff deft meff meft obs size^
  21.  
  22. and svyprop_options are 
  23.         ^str^ata^(^varname^) psu(^varname^) fpc(^varname^) by(^varlist^)^
  24.         ^sub^pop^(^varname^) nolab^el ^for^mat^(%^fmt^)^
  25.  
  26.  
  27. ^svymean^, ^svyratio^, and ^svytotal^ typed without arguments redisplay previous 
  28. results.  Any of the following options can be used when redisplaying results:
  29.         ^l^evel^(^#^) ci deff deft meff meft obs size^
  30.  
  31. All of these commands allow ^pweight^s and ^iweight^s; see help @weights@.
  32.  
  33. Warning:  Use of ^if^ or ^in^ restrictions will not produce correct variance
  34.           estimates for subpopulations in many cases.  To compare estimates
  35.           for subpopulations, use the ^by()^ or ^subpop()^ options.  
  36.  
  37.  
  38. Description
  39. -----------
  40.  
  41. ^svymean^, ^svytotal^, ^svyratio^, and ^svyprop^ produce estimates of
  42. finite-population means, totals, ratios, and proportions.  Associated variance
  43. estimates, design effects (deff and deft), and misspecification effects (meff
  44. and meft) are also computed.
  45.  
  46. Estimates for multiple subpopulations can be obtained using the ^by()^ option.
  47. The ^subpop()^ option will give estimates for a single population.
  48.  
  49. For linear regression, logistic regression, and probit estimation with survey
  50. data, see help @svyreg@.
  51.  
  52. To describe the strata and PSUs of your data and to handle the error message
  53. "stratum with only one PSU detected", see help @svydes@.
  54.  
  55. To estimate differences (and other linear combinations) of means, totals, and
  56. ratios, see help @svylc@.  To perform hypothesis tests, see help @svytest@.
  57.  
  58.  
  59. Options
  60. -------
  61.  
  62. ^strata()^, ^psu()^, and ^fpc()^ are described in ^svyset^; see help @svyset@.
  63.  
  64. ^by(^varlist^)^ specifies that estimates be computed for the subpopulations
  65.     defined by different values of the variable(s) in the varlist.
  66.  
  67. ^subpop(^varname^)^ specifies that estimates be computed for the single
  68.     subpopulation defined by the observations for which varname~=0.
  69.     Typically, varname=1 defines the subpopulation and varname=0 indicates
  70.     observations not belonging to the subpopulation.  For observations whose
  71.     subpopulation status is uncertain, varname should be set to missing.
  72.  
  73. ^srssubpop^ can only be specified if ^by()^ or ^subpop()^ is specified.  ^srssubpop^
  74.     requests that deff and deft be computed using an estimate of simple-
  75.     random-sampling variance for sampling within a subpopulation.  If
  76.     ^srssubpop^ is not specified, deff and deft are computed using an estimate
  77.     of simple-random-sampling variance for sampling from the entire
  78.     population.  Typically, ^srssubpop^ would be given when computing
  79.     subpopulation estimates by strata or by groups of strata.
  80.  
  81. ^nolabel^ can only be specified when ^by()^ is specified.  ^nolabel^ requests that
  82.     numeric values rather than value labels be used to label output for
  83.     subpopulations.  By default, value labels are used.
  84.  
  85. {^complete^|^available^} specifies how missing values are to be handled.  ^complete^
  86.     specifies that only observations with complete data should be used.
  87.     ^available^ specifies that all available nonmissing values be used for each
  88.     estimate.
  89.  
  90.     If neither ^complete^ nor ^available^ is specified, ^available^ is the default
  91.     when there are missing values and there are two or more variables in the
  92.     varlist (or four or more for ^svyratio^).  ^complete^ must be specified to
  93.     compute the covariance or to use ^svytest^ or ^svylc^ after running the
  94.     command; see help @svytest@ and help @svylc@.
  95.  
  96. ^format(%^fmt^)^ (^svyprop^ only) specifies the display format for the proportion
  97.     estimates and their standard errors.  The default is ^%9.6f^.
  98.  
  99. ^level(^#^)^ specifies the confidence level (i.e., nominal coverage rate), in
  100.     percent, for confidence intervals; see help @level@.
  101.  
  102. ^ci^ requests that confidence intervals be displayed.  If no display options are
  103.     specified then, by default, confidence intervals are displayed.
  104.  
  105. ^deff^ requests that the design-effect measure deff be displayed.  If no display
  106.     options are specified then, by default, deff is displayed.
  107.  
  108. ^deft^ requests that the design-effect measure deft be displayed.  See 
  109.     ^[R] svymean^ for a discussion on deff and deft.
  110.  
  111. ^meff^ requests that the meff measure of misspecification effects be displayed.
  112.  
  113. ^meft^ requests that the meft measure of misspecification effects be displayed.
  114.     See ^[R] svymean^ for a discussion of meff and meft.
  115.  
  116. ^obs^ requests that the number of observations used for the computation of the
  117.     estimate be displayed for each row of estimates.
  118.  
  119. ^size^ requests that the estimate of the (sub)population size be displayed for
  120.     each row of estimates.  The (sub)population size estimate equals the sum
  121.     of the weights for those observations used for the mean/total/ratio
  122.     estimate.
  123.  
  124.  
  125. Examples
  126. --------
  127.  
  128.     . ^svyset strata stratan^
  129.     . ^svyset pweight finwgt^
  130.  
  131.     . ^svymean birthwgt^
  132.     . ^svymean birthwgt, by(race)^
  133.     . ^svymean birthwgt, subpop(race)^
  134.  
  135.  
  136.     . ^svyset strata strata^
  137.     . ^svyset psu psu^
  138.     . ^svyset pweight finalwgt^
  139.     
  140.     . ^svymean tcresult tgresult^
  141.     . ^svytotal heartatk, by(sex)^
  142.     . ^svyratio hdresult/tcresult^
  143.     . ^svyprop race agegrp^
  144.  
  145.  
  146. Also see
  147. --------
  148.  
  149.  Manual:  ^[U] 36 Overview of survey estimation^
  150.       ^[R] svymean^
  151. On-line:  help for @ci@, @svy@, @svydes@, @svylc@, @svyreg@, @svyset@, @svytest@
  152.